Installing a Library

Installation is handled by the beman_install_library() helper.

Function Signature

beman_install_library(name
    TARGETS <target1> [<target2> ...]
    [DEPENDENCIES <dep1> [<dep2> ...]]
    [NAMESPACE <namespace>]
    [EXPORT_NAME <export-name>]
    [DESTINATION <module-destination>]
)

Arguments

• name
  Logical package name (e.g. "beman.utility").
  Used to derive config file names and cache variable prefixes.

• TARGETS
  Targets to install and export.

• DEPENDENCIES (optional)
  Semicolon-separated list, one dependency per entry.
  Each entry is a valid find_dependency() argument list.

  NOTE: you must use the bracket form for quoting if not only a package name is used!

  "[===[beman.inplace_vector 1.0.0]===] [===[beman.scope 0.0.1 EXACT]===] fmt"

• NAMESPACE (optional)
  Namespace for imported targets.
  Defaults to "beman::".

• EXPORT_NAME (optional)
  Name of the generated CMake export set.
  Defaults to "-targets".

• DESTINATION (optional)
  Installation directory for C++ module interface units.
  Defaults to ${CMAKE_INSTALL_INCLUDEDIR}/beman/modules.

This function installs the specified project TARGETS and its FILE_SET TYPE HEADERS to the default CMAKE install destination.

It also handles the installation of the CMake config package files if
needed. If the given targets has FILE_SET TYPE CXX_MODULE, it will also
installed to the given DESTINATION

• *Used Cache variables

BEMAN_INSTALL_CONFIG_FILE_PACKAGES
List of package names for which config files should be installed.

<PREFIX>_INSTALL_CONFIG_FILE_PACKAGE
Per-package override to enable/disable config file installation.
is the uppercased package name with dots replaced by underscores.

Caveats

Only one FILE_SET of each TYPE is supported to install with this function yet!